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GENERAL 


‘The surveuahe B1700 HASP. progras enables a B1700 to ‘operate in 


conjunction with an IBM 0S/360» or 0$/370» performing the functions 


normatly associated with an off-line support computer. The IBM HASP 


system of automatic spooting and priority scheduling supports an 
unlimited number of remote peripherals operating simultaneously» 
via several classes of telephone tines. ‘ 


Through the use of the HASP Remote Job Eavey features a users 
Located perhaps thousands of miles from a particular System 360 or 
370 instattations can utilize the capabilities of the installation 
much as if the central computer were located at the remote site. 
The unit record devices (card readers» punches and printers) at the 
remote station are togicatly operated by HASP as if they were locat 


readers» printers» punches» and consoles» so that HASP can 


Simultaneousty» while operating alt local unit record devices» read 
jobs from severat remote readers into the queue of jobs awaiting 
processing and output to several remote printers and/or punches 
resutts of previously entered jobs which have completed execution. 


A special set of programs have been written for the B1700 which can 
be considered a togical extension of the HASP system. These 
programs perform the same functions as the remote terminal program 
for the IBM 360/20 computer. The I8M 360/20 remote terminal program 
was selected as the modet remote terminal in order to implement the 
i I of HASP. 


While the IBM 360/720 remote terminal progran te a stand-alone 
programs the B1700 HASP/RJE programas run under control of the 81700 
MCP. This gives the 81700 HASP/RJE all the resources found in a 
computer controlled by an operating system. For information on 
operation and facilities of the 81700 MCP» please refer to the 
Bi700 Software Operational Guide (SOG). | . 
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This neodue’ specification peasiwes of ‘sur wartions: each with a 
self-contained index and table of contents. uney are: | 


Section I Remote “Job Entry CHASP) 

| , Section [I HASP Environment nee ean 
| : Section ITI TESTBSC 

|  $ection IV BURRBSC 
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SYSTEM ARCHITECTURE 


The B1700 Remote Job Entry software consists of two programs, HASP 
and HASP/SPOOL. The remote terminal programs HASPs is responsible 


for maintaining the line discipline with the host system and 
managing the locat 1/0 of the remote site during a RJE session. 
HASP/SPOOL» the off-line input/output program which creates input 
spools and produces output spools» its described more fully in 
HASPCSection II). 


There. are two. modes of operation for the remote site: SPOOL and 
DIRECT. | 


SPOOL MODE 


SPOOL mode consists of three distinct phases. 


Phase #1: Input spoot creation (off-line) with HASP/SPOOL. 
Phase #23 Input spool transmission and receipt of output spool 
 Conetine) with HASP. 
Phase #33 Qutput spoot printing and peugenens (off- Line) with 
HASP/SPOOL. | 


Note:  "On-tine"* is defined as? connections via data comms 
: to the host HASP system. | 


"Off-Line" is defined as? no connection with the. 
host HASP system. 7 | a 
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SPOOL Phase #1 


The input spoot is created off-line by HASP/SPOOL in order to reduce | 


system requirements during the actual HASP/RJE session with the 
host. Cards are read» compressed» blocked and stored in a disk 
file. Many card decks may be concatenated to form one input spoot 
file. If more than one input spool disk file is to be transmitted 


during a sessions each must have a unique name. The spoot created 


by HASP/SPOOL is Labelled “HASP/CARDS". A subsequent execution of 
HASP/SPOOL will create another file Labetled "HASP/CARDS*". In order 
to retain both files» the first one must be changed froa 


"HASP/CARDS" to another name. Refer to 81700 SOG for disk fite 


tabel changing information. Phase #1 is more fully described in 
Section II CHASP/SPOOL) of this document. | 
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SPOOL Phase #2 


Phase #2 consists of executing HASPs» accepting appropriate run time 
parameters Crefer to RUN TIME PARAMETERS)» # establishing 
communications transaitting input spools» and receiving output from 
the host system. After communication is establisheds HASP signs on 
and enters a handshaking mode with the host. To transmit an input 
spool filter» the operator merely starts an input reader by entering 
the tocat HASP command <mix # of HASP>AX.SRi or <mix # = of 
HASP>AX.SR1 <filename>» where <filename> is an optional name of the 
input spool if the input spool is not labeled “HASP/CARDS". Refer 
to LOCAL COMMAND SUBMISSION for .SR1 format. 


After verifying that the input spool was created with the same run 
time parameters as HASP» a message is displayed “READER 1 OPEN” and 
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the file is transmitted. After the file has been transmitted, HASP > 
displays "READER 1 CLOSED". If another spoot is to be transmitteds 


the operator repeats the above procedure. 


Any output received during the spoot mode HASP/RJE session is 
written in its blocked and compressed from into the output. spool 
disk files HASPOUT. HASPOUT is initially labelled “"HASP/PRINTO1"%. 
Whenever HASPOUT is closed and re-opened during the HASP/RJE 
session Csee LOCAL COMMAND SUBMISSION)» the label for HASPOUT is 
incremented by 1. | 


The operator may écuuunteste with the host system by entering 
consote messages to HASP3 eeges <mix # of HASP>AXSDM<n>» “THIS I5 
A MESSAGE® would cause HASP to transmit the entire string folloning 
the <mix # >AX until ETX aS encountered. <n> is the remote ID. 


aag SPO command ukeee first cnenactees is a*." is interpreted as a 
focal command intended for HASP Csee LOCAL COMMAND SUBMISSION). 


Termination of Phase #2 is done by entering <mix # of HASP>AX.CLOSE — 


on the console which causes HASP to sign offs» close the output file 
and print a summary statistics report for this session. 
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Phase #2 SPOOL TRANSMISSION 
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SPOOL Phase #3 


Phase #3 prints and nunches data fron the Guroat: spool file. The 


operator executes HASP/SPOOL and. selects the output aode of 
operation. HASP/SPOOL reads the output spoot disk file catted 


“HASP/PRINTOI%» deblocks and decompresses the records» and then 


prints or punches the output. This is all done off-line to tessen 
system requirments during the actual HASP/RIE session with the 
host. Phase #3» is more fully documented in Section II 
CHASP/SPOOL). | | | : 


SPOOL MODE 


Phase #3 OUTPUT SPOOL PRINTING AND PUNCHING. 
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DIRECT MODE 


In DIRECT modes HASP maintains the Line discipline with the host and 
directly handtes alt tocal 1/0 (card readers card punch» line 
printer and SPO) at the remote site. 


The DIRECT mode is initiated by executing HASP and entering 
appropriate parameters for the particular remote site Crefer to RUN 
TIME PARAMETERS for formats). Input can be sent to the host by 
entering the tocal command .SR1 foitowed optionally by a file name. 
The format for -SR1i is described in command submission. 


After receiving a .SR1 commands HASP will request permission to send 
from the host» open the input file and display “READER 1 OPEN™. All 
input is read» compresseds blocked and transmitted to the host 
until end of file is detected. Upon detecting end of file in the 
card file» HASP will transmit an end of file message to HASP and 
sailed "READER 1 CLOSED*. | 


All output received is decompressed and output to ents printers 
anes or SPO. | 


The operator can communicate with the host via HASP. by entering <mix 
# of HASP>AXSDM<n>» “THIS IS A MESSAGE". HASP sends everything 
following the AX until an ETX fs encountered. The session can be. 
terminated by sending a sign off card or by entering <mix # of 
HASP>AX.CLOSE. Either one wilt cause HASP to sign off» print a 
Summary statistics reports and then go to end of job. : 


aa SPO cowesne jwose first character is a "2." is interpreted as a 
local command and intended for HASP. (see LOCAL COMMAND SUBMISSION) 


<n> is the Remote’s ID. 
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SYSTEM REQUIREMENTS 


The system requirements for 81700 HASP/RJE are: 


MCPII 

48K Bytes Wate Memory 
80" or 96-Colurnn Card Reader 

120- or 132-Position Printer 

SPO 

Disk (Cartridges Disk Pack or Head-per-Track) 
Single Line or Multi Line Control 

EBCDIC Bisync Adapter 

80- or 96-Cotumn Punch Coptional) 


Note: [BM OS object code reading and punching is supported on 
80 and 96 column equipment for MCPIT 5.1 or higher. 


Larger memory sizes are required when mite tpregreentag other jobs 
with HASP remote programse | 
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RUN TIME PARAMETERS 


Each remote. B1700. HASP/RJE system will have unique run time 
parameterss  ises.» buffer sizes remote ID» compression types etc. 
that are dynamically set at beginning of job. In the past these 
HASP variables were compiled into a remote program and any change 
in the remote necessitated a recompilation of the remote program. 


Currently» howevers HASP has a list of default run eles parameters 
that the operator can keep or override at the start of a HASP/RJE 
sessione | 


At the beginning of job» HASP witt interrogate program switch zero 
for a zero value. If a zero value is found (meaning switch was not 
set by operator when executing HASP)»s HASP will attempt to read a 
disk file labelled “HASP/PARMS® to obtain the appropriate run time 
Sarameters for this HASP/RJE session. If the “HASP/PARMS® file is 
found the syntax of the parameters in the file is checked. If the 
parameters are syntax error frees HASP proceeds to the 
establishment phase of the HASP/RJE session. To bypass the search 
for the "HASP/PARMS™ file on disks the operator should execute HASP 
as follows: 


EX HASP SW 0 aFaz 


"HASP/PARMS* disk fite can be created by "DMPALL"™ or any suitable 
card-to-disk program. Refer to PARAMETER DEFAULTS AND FORMATS’ for 
parameter defaults and formats. 


If any of the following occurs: 
| aed) SW 0 is set 


be) “HASP/PARMS” disk file not present 
Ce “"HASP/PARMS” disk file contains an invatid parameter 
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USE DEFAULT PARAMETERS? 


Run ttme parameter entry occurs 
responses to "USE DEFAULT PARAMETERS?* 


<¢mix # of HASP>AXYES 


<mix # of HASP>AXR 


<mix # of HASP>AXC{Parameter List) 


<mix: # of HASP>AX/*SIGNONes. 


this time. The acceptable 


are: 


"YES" means use of all the 
default parameters. Refer to 
PARAMETER OEFAULTS AND 
FORMATS for defaults. . 7 


“Re means read run time 


parameters from a card file 
“PARMS" labeled 


"HASP/PARMS®*. Refer to. 
PARAMETER LIST ENTRY for 
format of parameter file. 


(Parameter Listi is a tist 
of run time parameters. 
Refer to PARAMETER LIST 
ENTRY for format of 
parameter list. | | 


"/*eSIGNON. 2” is the exact 
format of the first 72 
coluans of a SIGNON card. 
This entry will override the 
default SIGNON card and any 
IDs or /*SIGNON found’ in 
subsequent parameter entry. 
After HASP has accepted the 
signon entrys the operator 
can continue with a YES» R» 
or (Parameter List) 
response. 


‘If none of the above are entered>s an "INVALIO RESPONSE» TRY AGAIN™ 


nesseve wil be displayed. 
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PARAMETER DEFAULTS AND FORMATS 


The table below tists default run time parameters. These parameters 
witt be used if repty in RUN TIME PARAMETERS is “YES. Specific run 
time parameter defaults are overridden by entry of that parameter 
in the (Parameter List} or by the presence of that parameter in the 
card file "HASP/PARMS". Omission of a parameter causes the default 
to be used. | 


Default parameters shoutd not be sete for examples SPOOL means SPOOL 
mode of operation and the absence of SPOOL means DIRECT mode of 
operation since DIRECT is not a vatid parameters : 


RUN TIME PARAMETER DEFAULTS 


Parameter § Meaning ) | Default 


SPOOL SPOOL mode of operation DIRECT mode of operation 
LEASED Leased Line | Switched Line 
PROSLEM Run with the DEBUG file Run with the DEBUG 
open - | _ file closed. | 
/*STGNONeee Signon card image REMOTE2 with no 
| | | | | password — 
ID=<n> Remote*s ID» where <n> is a 1D=1 


one or two digit number. 

If the ID is only one 

digits» do not precede it 

with a leading zero. Correct 
ID=1» incorrect ID=01. - 


BUFFER=<n> Teleprocessing buffer sizer | BUFFER=400. 
te where <n> is 3 or 4 digits | _ = 
from 132 to £095. Note <n> 
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must match the buffer size 

of the host system and. 
dynamic memory size aust be 
changed if default is not. 

used (See DYNAMIC MEMORY SIZED. 


ADDRESS= = | | 
—PSCsat _ Address of bisync ADDRESS=7 212202 
adapters where: | . 


P = one digit port # (0-7) 


C = one or two digit 
channel # (0-15) 


A = one or two digit 
adapter # (0-15). 


Note: Ending colon is 
required. 


 NONTRANS Non-transparent text | Transparent text 


Ce PRINTER=<n> Printer line sizes where  PRINTER=132 
| | €n> is = 132 or 120. <n> must 
match size of remote 
| : printer tine and 
po - generated size in host. 


|. QUEVE=<n> #$Number of buffers | QUEUE =2 
i | — allowed to be queued | 
7 : internaily before host 
is told to suspend 
transmission. <n> is 
a vatue from 2 to 4. 


coMP. TYPE= <n>Type of data compression |= COMP.TYPE=3 . 
where <n> = Op» 1» 2s or 3 _ & 


—~0 


ii 


no compression | 
1 = no compressions but 
strip trailing blanks 


2 = compress two or more 
blanks and strip 
traiting btanks 
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3 = all of the above plus 

| compress any occurrence | 
of duplicate characters 
-equat to or greater than 


| | COMPRESS ION. MIN 
COMPRESSION.  f 7 
MIN=<n> Number of consecutive | COMPRESSION.MIN#G | 
ae: 7 duplicate characters ts 
before compression 
occurs. <n> = 2 to 31. 
AUDIT Open “DC/AUDIT.FILE™ NO AUDITing 


at start of session 
and monitor data comm 
I/0- 


PARAMETER LIST ENTRY 


If the operator desires to override one or more of the default fun 
time parameters» he enters either °R* or ‘CParameter Listl» in 
response to “USE DEFAULT PARAMETERS?™. 


If the entry is through a (Parameter List] on the SPO» the operator. 
can enter up to 72 characters to override the default parameters. 
If more characters are requireds the operator must submit. the 

parameter(s) through the card file tabeled "HASP/PARMS". 


tf the entry is through the card files there may be one or more 
parameters per card and ali 80 columns of the card may be used. 
Howevers a parameter must be contained comptetety on a card peceyse 
there is no parameter continuation. 


The parameter entry» whether fron cards or SPO» is free form with 
the following Srceeeene: ee | a, 
any paraneter with an equat sign must? 


ae) not have any imbedded blanks 
be) be ended with a blank 
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If an error is detected Cinvalid keyword 
scan is ended» the next 8 characters are 
‘must correct the error and resubmit the 


overrides again. 
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or vatue)? the parameter 
displayed and the operator 
entire ist of default 
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OPERATING INSTRUCTIONS 


At the beginning of job HASP will set the run time parameters and 
verify that the data comm control and bisync adapter are present. 


Then HASP will wait for data set ready Catways present on teased 


lines present upon host answering call on switched tines) and then 
transmits a SOHENQ sequence. Upon recipt of an ACKO sequence’ from 
the host» the message “COMMUNICATIONS ESTABLISHED” is disptayed on 
the B1700 SPO. If the format of the signon message» remote ID or 


password is invalids the host will disconnect the remote. If the 


Signon is correct» the B1700 and the host wilt go into a 
“handshaking” phase until either one has a data stream to transmit 
to the other. | 


LOCAL COMMANDO SUBMISSION 


To submit a command to the host HASP systems enter the following: 


<mix # of HASP>AX.f local command} 
Presently there are five local commands supported. 


Cae) «SRI - Start Input Reader has four formats. 


1) «SRL - SPOOL mode witl cause transmission of "HASP/CARDS* 
input spoot disk file. In DIRECT mode it wilt cause 
transmission of “HASP/CARDSIN™ input card file. 7 


2) —~eSRL A = SPOCL mode wiil cause transmission of input spoot 
disk file tabelted “"A™ #. In DIRECT mode it wilt cause 
transmission of input card files labelled “A*.* 3 


3) SRI A/B - SPOOL mode will cause transmission of input — 
— spool disk file tabetled "A/B” #. In DIRECT mode it wilt 
cause transmission of input card file “A/B". * —- 
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(be? 


Cc.) 


(de) 


Cee) 


4) SRI A/B/C - SPOOL mode witt cause transmission of “B/C 
from disk pack tabelled “A” *. In OIRECT mode it wil 
cause transmission of "B/C" from disk pack tabelled “A”. 

® | | 


* A» B and C are character strings of 10 characters or less. 
eCLOSE = Close down system. .CLOSE will cause transmission of 


a /*eSIGNOFF card and ctose down of system when current streams 
have compteted. | 


sNEW“SPOOL - If in SPOOL modes .NEW-SPOOL witt cause the 


current output spool to be closed as soon as ait current 
output streams are finished and a new output spoot to be 
opened with anew nmamee Any new output streams wilt be 
suspended until a new output spoot is open. If in DIRECT mode 
eNEW"SPOOL is an tnvatid tocat command. 


eAUDIT = If the data comm 1/0 monitor is auditing the data. 


comm I/Qs .AUDIT will stop the auditing and close the audit 


file. 


If the data comm I/0 monitor is not auditing the data comm 1/0 
eAUDIT will open the audit file and start data comm 1/0 
monitoring. : | “ 


eJCLI =~ Allows the remote HASP user to separate his JCL. rere 
the data stream. .JCL1 can be used for any job that contains 


all necessary JCL before the data stream that is» multi-step 


jobs are prectuded unless the JCt for step 2 and further steps 
is included in the data stream. 


e-JCL1 opens a card file tabelted "HASP/JCL*™ that must contain 


alt the necessary JCL for this job execution. End of fite on 


“HASP/JCL™ will cause “HASP/JCL”® to be closed and a card file 
labelled $“"HASP/CAROSIN® to be opened. The records in 
"“HASP/JCL* and “HASP/CARDSIN® will appear as one contiguous 
card stream to oe nuances is an invatid pecer “command 
when in SPOGL mode. 7 


Pakess: it appears. sowauhece within the “HASP/CARDS IN" file, 
the last JCL card in “HASP/JCL” must be: | 
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J7NAME OD * 
Alternate file names that are supported for .SR1 are not 
supported for -eJCLLl. - 3 
eJCL1I exanpte: 


Given: | 
ae) JCL is a card deck. | 
b.-) Data stream is a tape file. 


Place the following deck in the card reader: 


2DATA HASP/JCL 


} ib 0 GD a Oh GR ED OS aD a a a } 


i JCL CARDS 1 


/S/NAME DD * 
PEND 


Mount tape Labetled “HASP/CARDSING. 
Enter the following local command: 
- <mix # of HASPDAX.JCLI | 
The cards in the card reader witt be read and then the 


records on the tape witt be read. All records wiit be 
sent to the host as one contiguous data stream. 


ALL SPO entries not beginning with a °.* are sent to the host for 
analysis and error reporting. | a | | 


Baptist 


| ; | — 1°21 
BURROUGHS CORPORATION ae ss COMPANY ‘CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | : B1700 HASP (Section I) 


SANTA BARBARA PLANT | PeSe 2212 5256 


CHANGE FORMS PROCESSING 


In DIRECT mode when a special LOAD FORMS message is received» the 
HASP program wilt display the message and the host will wait for a 
start message signaling completion of forms change. 


When necessary forms pave, reer: changed (cards for punch)s the start. 


message is as follows: 
SWE # of PRS EAR sO Snes PR1 Cor PU1) 


where. <n> ds the remote ID. 


In SPOOL wode when a special LOAD FORMS message cr received» the 


HASP program writes the LOAD FORMS message to the output spool and 


generates the correct response to the host automaticalty. 
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SUMMARY STATISTICS REPORT - 


When closing down the 81700 HASP/RJE sessions a summary statistics 


reports named HEREP CHasp Environment Recording Error Printout)» is 


printed. The format of the HEREP report is: 


HASP ENVIRONMENT RECORDING ERROR PRINTOUT 


ERROR ID ss CUMULATIVE COUNT OF LAST SESSION — 
BLOCK SEQ CK 000000 | | 
ERROR REPLY KKK RIK 
INVALID RESP XXX KX AXX 
TOTAL LINE ERRORS — XXX XK AXX 
“TIMEOUTS | | XXXXK XXX 
CRC | XXX KA KKK, 
“OTHER LINE ERRORS © XXXXXXXX 
NAKS ROVD AXXXX XXX. 
NAKS SENT XXX XXX 
BLOCKS WRITTEN = XXXKXXKX 


BLOCKS READ | XXX MXXXX 
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FILES 


Te Common Fites 


Parameter file - "PARMS”™ Labeled “HASP/PARMS". 
Record Size is 80. 
Blocking factor is 1. : 
Device? ae) If program switch zera is not sets | 
device is disk. | 
be) If program switch zero is set» 
device is card. 
Ce) If device is disk ad file is not 
present» device is changed to card. 


Audit File - *AUDIT® tabeled *"DC/AUDIT. FILE" 
. Record Size is 180. 
Blocks per area is 10. 
Areas are 100. 
Device is random disk. 
The audit mechanism may be started by entering AUDIT 
as arun time parameter or entering eAUDIT as a local 


2] commande 
a Debug File - “DBUGPRT® Labeted SeeouCre eer ge. 
Record Size is 132. 
Blocking factor is 1. 
Device is printer. 
The debug mechanism may be started by entering | 
“PROBLEM” as a run time parameter. - 


Summary Results File - “HEREP® labeled “HEREP/REPORT™ | 
| a Record Size is 132. 
Blocking factor is 1... 
Device is printer or backup disk. 


| Il. SPOOL Mode Files 


Input - "HASPIN®@ Labeled *HASP/CARDS*. 
Record Size = buffer size. — 
Blocking factor is 1. 
Device is disk. 
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Ifl. 


Note: 


Cperator may request "HASPIN® with another 


label by use of the .SR1 filename local 


command. 


eee - “HASPOUT™ tabeted “HASP/PRINTO1™.« 


Note? 


DIRECT 


Input - 


Note: 


Record Size = buffer size. 
Blocking factor is 1. 
Device is disk. 


~ "HASPOUT® output spool #1 is) Cabeled . 


"HASP/PRINTOIL™. Any subsequent spools due to 


spoot fitting completely or .NEW-SPOOL local 


commands will be labeled “HASP/PRINT<nn>"» 
where <nn> is incremented by 1 for _ each 
Subsequent spool. 


Mode Files. 


“HASPCARDS® labeled "HASP/CARDS IN". 
Record Size is 80. © 

Blocking factor is 1. 

Device is card. 


Operator may request “HASPCARDS” with another 
Label by use of the .SRi fitename local 
commande : | 


QDutput - "HASPPRINT® Labeled “HASP/PRINT"™. 


Record size is print size. 
Blocking factor is 1. 
Device is printer or backup disk. . 


-“HASPPUNCH™ labeled “HASP/PUNCH® « 
Record size is 80. 

Blocking factor is 1. 

Device is punch or backup disk. | 


1-24 


COMPANY CONFIDENTIAL | 
B1700 HASP (Section I) 


' i 
' 


| | | | a 1-25 
BURROUGHS CORPORATION _— —  GOMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP -, # B1700 HASP (Section I) 


SANTA BARBARA PLANT | | PeSe 2212 5256 


DYNAMIC MEMORY SIZE _ 


The HASP buffer sizes are determined by the run time parameter» 


Buffer=<n>» where <n> is the size of the teleprocessing buffer 
declared in the host system. In order to accommodate all 
installations» memory buffers are kept in a dynamic memory area. 


The dynamic size is computed by: 


CCBUFFER SIZE # 14)*498) # (BUFFER SIZE*(CQUEUE SIZE#2) ¢ 3) #8) 


For any buffer size different from the default size of 400 bytes 
(3200 bits)» the HASP program must be modified via the MCP or 
executed with a memory statements i.@e» ) 


2EX HASP 
2ME=35648 


where the ME statement specifies the number of bits as computed 


above. 


NOTE: In SPOOL mode whenever the dynamic memory size of HASP 
is changed» the dynamic memory size of HASP/SPOOL must 
be changed. Refer to HASP/SPO0L documentation for 
modifying of HASP/SPOOL dynamic memory size. 
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HASP has five types of SPO messages? 


Cae) INFORMATIONAL | 
(be) PARAMETER ANALYSIS 


(co) INPUT SPOOL ANALYSIS 


(do? ERROR 
Ce.) HASP 


INFORMATIONAL MESSAGES — 


Informational messages display the status of HASP.« The following = 
a table. of informational messages: 


Message 


RETRIES EXHAUSTED ON I/0 
ERRORS COUNTER REINITIALIZED | 


RETRIES EXHAUSTED ON 
INVALID RESPONSES COUNTER 
REINITIALIZED 


NNNN SPOOLS TRANSMITTED 


READER 1 OPEN 


121 consecutive 170 errors occurred 

and exhausted atl retry counters. HASP 
continues to execute but the session 
should be terminated and the connection 
hardware checked. 


121 consecutive invalid responses were 
received. HASP continues to execute but 
the session should be terminated and the 
connection hardware checked. 


HASP displays the number of spools 
transmitted during the current SPOOL mode 
sessione This message 1s duserayes at 
end of job. 


HASP has opened the input spoot Cif 


SPOOL mode) or input card file if in 


DIRECT modes — 
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READER 1 CLOSED 


<Filename> MISSING READER 
NOT OPENED 
SPOOL WAS EMPTY 


CAN'T SEND INPUT SIGNING 
OFF oe 
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HASP has sent an end of file message to 
the host system for the current input 
stream. | 


Operator started reader while in SPOOL 
mode and the disk-file filename was not 
present. | 


The input disk spoot contained no records. 


Operator has attempted to start an input 
reader white HASP is signing off. 


PARAMETER ANALYSIS MESSAGES 


PARAMETER ANALYSIS MESSAGES are messages displayed whenever an error 
is detected in analyzing run time parameter entry. 


Message | 


INVALID ID PARAMETER 


NO PARAMETER ENTERED 


INVALID ADDRESS PARAMETER 


INVALID BUFFER PARAMETER 


INVALID PRINTER PARAMETER 
COMPRESSION TYPE INVALID. 


INVALID COMPRESSION MIN 


Reason 


Run time parameter for ID=<n> is not a one 


or two digit entey or is not followed by 
a blank. 


No entries on record in file “HASP/PARMS™. 


Run time parameter for ADDRESS= is not 
in the form ADDRESS=P:C2A: or the ports. 
channet or adapter number ts itnvatid. 


Run time parameter for BUFFER= is not ins 
the range of 132 to 4095 or is not | 
followed by a blank. 


Run time parameter for PREMEERS ais not 
120 or noes | 


Run time parameter for COMP. TYPE= is not. 


0» Ll» e or 36 


Run time parameter for cereale 
is not in roe pence 20° 31. | 
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INVALIO QUEUE PARAMETER = = Run time parameter for QUEVE= fs not in| 


the range 2 - 4. 


XXXXXX INVALID PARAMETER | Message is désplayed upon detection 
PLEASE CORRECT AND RE-ENTER of first error in a parameter list. 


XXXXXX is invalid entry. Alt parameters 
must be re-entered. 


USE DEFAULT PARAMETERS? Request for run time parameter entry” 
-  # Csee RUN TIME PARAMETERS) 


INVALID RESPONSE» TRY AGAIN Neither "R"> “YES"» parameter list 


nor /*SIGNON was entered in response 
to “USE. DEFAULT PARAMETERS”. : 


PARAMETER FILE ON DISK "HASP/PARMS” disk file contained 
NOT VALID a  §invalid parameter and will not be 


used for run time parameters. 


INPUT SPOOL ANALYSIS MESSAGES 


When the input disk spoot is openeds the first record which contains 
the parameters with which the spool was created are compared to the 


current run time parameters and the following messages are 
displayed if any errors are detected: 


Message _ _ | Reason 
SPOCL HAS WRONG BUFFER ~ Spool was created with a different 
SIZE» FILE CLOSED | buffer size than the current HASP — 


buf fer Size. 


WARNING COMPRESSION TYPES . The compression type of HASP is not 


ARE DIFFERENT | the same as the spoot. The spool 
| : ; is stilt transaitted to the host. 
WARNING SPOOL INDICATED _. HASP is executing in transparent mode 
NON@“TRANSPARENT but the spool indicates non-transparent. 
TRANSMISSION | The spool is stiii eransettted to 


the host. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


WARNING SPOOL*S ID XX NOT 
THE SAME AS HASP IO XX — 
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The ID of the spool does not match 
that of HASP. The spool is still | 
transmitted to the host. 
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ERROR MESSAGES 


> ah a ap Ob ab Un OD On On EN a an 


Error messages are displayed 


detected by HASP. 


Message 


INVALID SPO MESSAGE 


SWITCHED ADAPTER BUT HASP 
CALLS FOR LEASED 
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whenever an operational error is 


Reason 


Operator entered an invalid locat 
command. “." must precede local 
commands» 466 exaapte. 


HASP was executed with run time | 
parameters indicating a teased tine. 
Howevers the adapter was found to be 


strapped for switched tine. The 


LEASED ADAPTER BUT HASP 
alas FOR SeEuEREE 


NON BISYNC ADAPTER 
NNNNNNN- : 


NO CONTROL PRESENT 


adapter must be removed and the 
jumper chip changed. A Clear/Start 
is then required. oe 


HASP was executed with run time 
parameters indicating a switched 
line. Howevers the adapter was 

found to be strapped for teased tine. 
The adapter must be removed and the 
jumper chip changed. A Clear/Start 


4s then required. 


NNNNNNN is the adapter ID. Either 


the wrong adapter was used or the 


address of adapter was wrong. 


HASP determined that there was no 
data coan control at Specified 


| address. 


INVALID PERMISSION TO 
SEND 


An invalid permission to send was 
received from the host. The 


permission to send is ignored. 
Permission was not in response to 
request to sends | 
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_ENVALTD RCB. 


DYNAMIC SPACE. Nor LARGE 
ENOUGH. "4 | 


ERROR? CONTROL BYTE. 
INVALID» BLOCKED SKIPPED 


ERROR: ONLY ONE INPUT 
OR OUTPUT STREAM CURRENTLY 
ALLOWED 


SEQUENCE ERROR ENCOUNTERED | 


CCOUNT) 


ERRORS ONLY ONE OUTPUT 
STREAM ALLOWED» RECORD 
| SKIPPED 


ERROR? INVALID “SRCB" 
RECORD SKIPPED 


ERROR? INVALIO SCB 
LENGTH ENCOUNTERED 


INVALIO MESSAGE LENGTH 
ENCOUNTERED 


 nuaber. 


record size. 
equal to record size is processed. 
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an invaltd RcB was received from 
the host. 


The block is discarded. 


The dynamic memory area was not large 
enough to hold the buffers. HASP is 
cancelled and the dynamic memory size 
must be corrected. 


The first record in the message blocks 
passed between the RTP and I0 procedures 
contains a control byte. Should this 
controt byte be invalid this message 
will be displayed and the block ignored. 


Since multipte devices are not currently 
possibles shoutd a block be received 

for anon supported devices this message 
is displayed and the block ignored. 


AUL message blocks passed between the 


RTP and 10 procedures contain a sequence 
Should an outcof-sequence message 
block be detected» this message ts 
displayed. 


Message block contained a control 
byte for other than stream number 1. 


Message block contained an invalid SRCB. 


Length of SCB was greater than output 
~Onty portion of record 


Att mess age blocks have a tength field 
giving the Length in bytes of the text 
in the block. Should this length be. 
greater than permitteds this message 
will be displayed and the permitted. 
portion of the block is processed. 
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HASP. MESSAGES 


ALl operator messages received from the host system are decompressed. 
and displayed. These messages will always start with a *$*. 


B1700 HASP OPERATING EXCEPTIONS WITH 360/20. 


I. Channet Skips: | 3 
Not alt. Burroughs® Line ghanbees. are ‘capable of handling a ‘ekip 
to channel 12. If such a skip is to be dones check to verify 


that this is possible on the system on which HASP is to be 
fune | . ; | 


_ It. File Closing: | 3 | 7 
Se 7 HASP opens and closes its output files many times within a 
a session. Often an open is issued immediatety after the fite 
has been closed» and the MCP has not comptetety closed the 

device. When this ts the cases a message: | 


"PRINTER OR BACKUP DISK REQUIRED FOR "HASP/PRINT<nn>* 


will be displayed. When the device is fully closed» the file 
will be automatically opened. Ali printer and punch files are 
declared optionally as disk backup. If the MCP “PBD" option is. 
set and above case occurs or output is directed by the MCP 
command "QU" to disks all subsequent output will automatically 
go to disk backup. , 
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GENERAL 


This section describes the use of a Burroughs B1700 as a HASP remote 
Stations ic@en the HASP/ SPOOL program and its use in the HASP 
environment. The HASP program was described in HASPCSection I). 


SPOOL MODE 


SPOOL mode consists of three distinct phases. 


Phase #1 Input spool creation Coff line) with HASP/SPOOL. 
Phase #2 Input spool transmission and receipt of output spool 
| Con line) with HASP. 
Phase #3 Output spool printing and punching Coff Line) with 
| | HASP/SPOOL. ? 
NOTES "On tine" is defines as? eunnected via data comm to the 
host HASP system. 


“Off Line* is defined as: no connection with the host 
HASP system. | 
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SPOOL Phase #1 


The input spoot is created off tine by HASP/SPOOL in order to reduce 

_ System requirements during the actual HASP/RJE session with the | 
host. Cards are read» compressed» and blocked and stored in a disk 

file. Many card decks may be concatenated to fora one input spool 

file. If more than one input spoot disk file ts to be transmitted 

during a sessions each must have a unique name. The disk file 

created by HASP/SPO0L is tabelled “HASP/CARDS™. A subsequent | 
execution of HASP/SPOOL wilt create another file labelled 

“HASP/CARDS™. In order to have both files the first one must be 

changed from “HASP/CARDS" to another name. Refer to 81700 SOG for 

disk file tabet changing information. | | 


SPOOL MODE. 


PHASE #1 INPUT SPOOL CREATION 


OD BEBO HORA BODOe ROBB eA aae 


4 | 
{ MCP II | 
i “— *% 4 é 
—"HASP/CARDS” 1 ee Oe 1 “HASP/CARDSIN® 
| kekkkk he { | $ or we nwmaemawoay |  Pk&aKRaEeEK RARER 
fe ee 4 i og ot | ft 
* DISK s<eewwmrmnn= § HASP/SPOOL I <nwnemmmnwe « CARD READER * 
- 3 we 4 | q | | & & 


f fom amewemenmony i 

1 an 4 i 
i i esr “f= _ { 

' #—>9SPO8>—-+ ae 
' = 4 

f . 
& + 
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SPOOL Phase #2 


Phase. #2 consists of executing HASP» accepting appropriate run time 
parameters (refer to RUN TIME PARAMETERS of HASP(Section I))>» 
establishing communications transmitting input spools» and 
receiving output from the host system. After communication § is 
established» HASP signs on and enters a handshaking mode with the 
host. To transmit an input spoot files the operator starts an input 
reader by entering the tocal HASP command <mix # of HASP>AX.SRI1 or 
<mix # of HASP>AX.SR1 <filename>» where <filename> is an optional 
name of the input spoot if the input spoot is not tabetted 
"HASP/CARODS". | : | 


After verifying that the input spoot was created with the same run 
time parameters as HASP» a message is displayed “READER 1 OPEN” and 
the file is transmitted. <After the file thas been comptetety 
transmitteds HASP displays "READER 1 CLOSED". If another spool is 
to pe transmitted» the operator repeats the above procedure. 


Any output received during the spool-mode HASP/RJE session is 
written in its blocked and coapressed form into the output spoot 
disk  fite HASPOUT. HASPOUT is initially tabelled “HASP/PRINTO1". 
Whenever HASPOUT is closed and reopened during the HASP/RJE session 
(see SPOOL MODE INPUT OPERATION of HASP{(section I))»5 the label for 
HASPOUT is incremented by 1. 


The operator may communicate with the host system by entering 
console messages to HASP. For examples <mix # of HASP>AXSDMs “THIS 
IS <A MESSAGE® would cause HASP to transmit the entire string 
following the <mix #>AX until ETX is encountered. Any SPQ command 
whose first character is a “." is interpreted as a locat command 
intended for HASP (see SPOOL MODE INPUT OPERATION of HASPCSection 
Id). Phase #2 is terminated by enterning <mix # of HASP>AX.~CLOSE on 
the console which causes HASP to sitgn off» close the output fite 
and print a summary statistics report for this session. 
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SPOOL MODE 


Phase #2 SPOOL TRANSMISSION 


$ oO ween ewmameewocamawwwny | . 
t | 7 “HASP/CARDS* 
68 MCP ITI en i REaRRRee 
wkanth et f : , t tore ff 
wae é | ( { «© DISK « 
Be SLO OF trensemmnn sy tt to + 
st  te—[e ee | | | <asmwmmmnny 8 eeeanante 
wwreeDeca==>8Se# OR I<-""">§ HASPS 1g 
\  #S« “Yn i § SPOOL Jowweewwn nny "HASP/PRINT® 


cone eee #Ne MLC { $$ se ereeea wan 5 @ q RRaRkaR 


«Cx | § #nwnmye 7 
ene | ‘ 4->91SP0l>-4 
kktkaany orem sy 


f +#=—>* DISK « 
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SPOOL Phase #3 


Phase #3 prints and punches data from the output spool file. The 


(operator executes HASP/SPOOL and selects the output mode of 
operation. HASP/SPOOL reads the output spoot disk file called 


“HASP/PRINTO1%»  debtocks and decompresses the recordss and then 
prints or punches the output. This is all done off-line to tessen 
System requirements during the actual HASP/RJE session with the 


host. 
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SPOOL MODE 


Phase #3. OUTPUT SPOOL PRINTING AND PUNCHING: 


= @) an OD an an OD A a Oo ARAMA REREAD AAaAn ae oo 1 ae a an ain a am om aw 


Pewee wenwn mame wmaasorens 
i 7 | 1 | 
| { | MCP IT i *HASP/PRINT® 
. 4 . a FFD EKKEKRKRERTR 
"HASP/PRINT™ @. | ¢ d * PRINT « 
t$kkakkhnt ' Prete wnaeceuant | f | kkk kkakkk 
® * § i . § <ewoeero—+ 
® DISK seeeeer""—>f HASP/SPOOL I § 
* * | | | { <ewmerern4 — 
e@etkekeeh t trees essen esrs: ~ i {  SHASP/PUNCH® 
q # ¢7--¢ #8 | $= > RAHRREERE 
a #->ESPOI-->+ A * PUNCH * 
{ | foreey oo RRERREREK 
J : : 
a + 


: | | | 
wih ‘ 
ae 

ie 

Mis 

a F , 

wn 

i . 

iy 


(DIRECT MODE 


<> ao an an an oe a a 


HASP/SPOOL program is only an off-line service program and does not 
execute in Direct Mode. Refer to HASP (Section I) for description. 
of Jirect Mode. | 7 | 
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SYSTEM REQUIREMENTS 


The system requirements for B1700 HASP/RJE are specified in Section 
I of the HASP documentation. 


The minimum system for HASP/SPOOL are: 


MCPII | . : 

32K Bytes Main Memory | 

80" or 96-Column Card Reader 

120° or 132=Position Printer | 

SPO | | | | 
Disk (Cartridge Disk Pack or Head=Per-Track) 
‘An 80° or 96=Column Card Punch in optional 


NOTE: I8M OS object code reading and 


punching is supported on 
89- and and 96-column equipment. | | 
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RUN TIME PARAMETERS. 


Fach remote 81700 HASP/RJE system will have unique run time 
parameter Se teeos buffer sizes» remote ID> compression types etc. 
that are dynamically set at beginning of job. In the past these 
HASP variables were compiled into a remote program and any change 
in the remote necessitated a recompilation of the remote program. 


~ HASP/SPOOL requires knowledge of some of these parameters to create 


compatible spools for tater transmission and to process spools from 
a previous HASP/RJE session. © | | 


HASP/SPOOL requires only a. subset of the run time parameters 
required by HASP. For ease of operation» the same parameters> 
whether required by HASP/SPOOL or nots» can be entered to HASP/SPOOL 


as to HASP. Unused parameters are syntax checked and then ignored. 


HASP/SPOCL has a list of. default run time. parameters that the 
operator can change or override at the start of HASP/SPOOL 


execution. 


At the beginning of job» HASP/SPOOL wilt interrogate program switch 
zero for a zero value. If a zero value is found (meaning switch was 
not set by operator when executing HASP/SPOOL)> HASP/SPOOL witl 
attempt to read a disk file tabelled “HASP/PARMS" to obtain. the 
appropriate run time parameters for this execution of HASP/SPOOL. 
If the "HASP/PARMS™ file is found, the syntax of the parameters in 
the file are checked. [ff the parameters are syntax error frees 


HASP/SPOOL sets a flag indicating parameters from disk were read 
and are valid. | 3 7 | 


To bypass the search for the "HASP/PARMS” file on disk the operator 
Should execute HASP/SPODL as follows: - 7 : | 


EX HASP/SPOOL SW 0 aF a3 
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"HASP/PARMS™ disk file can be created by “DMPALL™ or any suitable 
card-to-disk program. Refer to PARAMETER DEFAULTS AND FORMATS for 


QOarameter defaults and formatse 


After HASP/SPOOL has determined the run mode for this execution of 
HASP/SPOOL (CRefer to SPOOL MODE OPERATING INSTRUCTIONS for 


operating instructions) and if any of the following occured: 


a) SWO is set» 
b>) “"HASP/PARMS* disk file not presents 
¢c)- “HASP/PARNS® disk file contains an invatid parameter, 
HASP/SPOOL will display the message: | 
USE DEFAULT PARAMETERS? 


Run time parameter entry occurs at this time. The acceptable 


responses to “USE DEFAULT PARAMETERS?" are: 


<mix # of HASP/SPOOL>AXYES ““YES* means use of all the. default 
| | parameters. Refer to $$ PARAMETER 
DEFAULTS AND FORMATS for defaults. 


<mix # of HASP/SPDOL>AXR "R™ means read run time parameters 
| Oo i. - from a card file -"PARMS*” tlabeted 
— *HASP/PARMS™. Refer to PARAMETER LIST 

ENTRY for format of parameter file. — 


<mix # of HASP/SPOOL>AX {Parameter List] is a list of run 


C(Paramter List]. 2 time parameters. Refer to PARAMETER 
7 oe LIST ENTRY for format of parameter. 
| tist. . . 
<mix # of HASP/SPOOL> —"/*SIGNONS "is the exact format of 
AX/*STGNONe oe the first 72 columns of a signon card. 


This entry wilt override the defauit 
signon card and any IDs or /*SIGNON 
found in subsequent parameter entry. 

After HASP/SPOOL entry» the operator 
can continue with a YES» R» or 
(Parameter List) response. 


If none of the above are entered» an ENVALID RESPONSE» TRY AGAIN™ 
‘message will be pEapayets 3 


2-9 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | | B1700 HASP CSection IT) 


SANTA BARBARA PLANT | Pe Se 2212 5256 


PARAMETER DEFAULTS ANO FORMATS 


OOOO ABE EE BEER DED AEEOEDBDO OD 


Sa ee En ae aR ce ERS a La oe ge aed CS i ce A et a Re Sit ean gE NE TE 


The table below lists all the default run time parameters. These 

parameters wilt be used if the reply in RUN TIME PARAMETERS is 
"YES". Specific run time parameter defaults are overridden by entry 
of that parameter in the parameter tist or by the presence of that 

parameter in the card file "HASP/PARMS*. Omission of a parameter 
causes the default to be used. : | 


a secs a 


Note: Default parameters should not be set. For example: 

oo  -§POQOL» means SPOOL mode of operation and absence of 
SPOOL means DIRECT mode of operation. DIRECT is not a 
valid parameter. | 


RUN TIME PARAMETER DEFAULTS 


Parameter — Meaning | Default 


«SPOOL | SPOOL mode of operation = OIRECT mode of 


| operation 
“#LEASED Leased Line | Switched Line 
*PROBLEM Run with the DEBUG file Run with the DEBUG 
: open 3 file closed a 
#/*S IGNONes. Signon card image - REMOTE1 with no 
, | a | | password = | 
: eIDe<n> Remote*s ID» where <n> is a I0=1 
Bo os | one or two digit number. | 
If the ID is only one 
digit» do not precede it 
with a teading zeroe 


Correct: ID=t» 
Incorrect: ID=01 


PERPEESEDI BEDE PEP ERB PERHEPEPERER ERSTE 


s* BUFFER=<n> 


*ADDRESS= 


PSCsa 
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Teteprocessing buffer size BUFFER=400 
where <n> is 3 or & digits | 


from 132 to 4095. Note <n> 


must match the TP buffer 
size of the host system 
and dynamic memory size 
must be changed if defautt 
is not used (See DYNAMIC 
MEMORY SIZE}. 


Address of Bisync Adapter ADDRESS=7 21220: 
where: _ | 


P=one digit port # (O-7) 


C=one or two digit channel 
# (0°15) _ - , 


Azone or two digit adapter | 
€# €0"-15) | a 


Note? Ending colon is required. 


*NONTRANS 


#*PRINTER=<n> 


* QUEUE=<n> 


Non~transparent text | Transparent text 


Printer line sizes where <n> PRINTER= 132 
7S = 132 or 120. <n> must 

match size of remote 

printer line and generated 

size in host. 


Number of buffers attowed QUEVE=2 


to be internatty Queued 
before host is told to 


suspend transmission. <n> is 


. @ vatue from 2 to he 


**COMP.TYPE=<n>Ty pe of data compressions COMP.TYPE=3 


where <n>- = Oe is 29 or 3 


0O=no compression 


1s no compression but strip 


trailing blanks 


2=compress two or more 


e 11 
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blanks and strip trailing | 
blanks 


3=alt of the abeve ptus 

compress any occurrence of 
duplicate characters equal i 
: : to or greater than : 3 _ 
: COMPRESSION.MIN _ a - Se 


eau IT Open “DC/AUDIT.FILE® at No AUDITing 
po start of session and 7 = 
monitor data comm 1/0. 


#*COMPRESSION. | | ) 2 
MIN=<n> Number of consecutive - § COMPRESSION.MIN=4 | 
| duplicate characters before | | 
compression occurs. 

<n>= 2 to 31s. 


Spry. inciuaed to keep. parameter file compatible with HASP Daraneters. 
«*Parameter is vital to HASP /SPOOL. | _ 


© _ PARAMETER LIST ENTRY 


, ( 


- If the operator desires to override one or more of the default | run 
SG time parameters» he either enters R or (Parameter List) on the SPO» 
_ in response to “USE DEFAULT PARAMETERS®. 


If the entry is through a (Parameter List] on the SPO the operator 
can enter up to 72 characters to override the default. parameters. 
If more characters are required the operator must submit. the 
Peroaecene emeauan the card file labeled “HASP/PARMS™. | 


I f the entry is through the card files there may be one or = more 
Parameters per card and all 80 columns of the card may be used. 
| However» a parameter must be contained completely on a card because 
2 there 1S no parameter continuation. | 


ee - . ee 
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The parameter entry, wheather from. cards” or “SPO, is. free form with 
the foltowing exception? wy . 


Any parameters with an equal sign must. 


Cae) not have any imbedded blanks 
Cb.) be ended with a blank 


If an error ts detected Cinvatid keyword or vatue) the parameter 
scan is ended» the next 8 characters are disptayed and the operator 
must correct the error and resubmit the ENTIRE tist of default 
overrides again. 


Se A a cE ne oo 
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SPOOL MODE OPERATING INSTRUCTIONS 


_ HASP/SPOOL is executed by the operator. By the use of operator 


commands» HASP/SPOOL can perform the following functions: 


le Read a card file> compress it» build HASP transmission 
— . blocks and write these blocks to a disk file “HASP.QUT” 
labeled "HASP/CARDS*. | 


2. Read a disk file “HASP.IN™ Labeled “HASP/PRINT<nn>*, 7 
decompress the disk file and print or punch the files. 
recordss where <nn> is O01 to 99. : 7 | 


Upon executing HASP/SPOOL> the following messages witt be displayed? 


SPOOLED MODE | 
ENTER .SR1 FOR INPUT OR ~SP1 
FOR OUTPUT OR «BOTH FOR INPUT 
AND OUTPUT TOGETHER 

ACCEPT 


The operator then enters? 
<mix # of HASP/SPOOL> 
ae «SRI <filename> 


°SR1 is for reading an input card. file and creating 
“HASP/CARDS™ disk spool. | > oO 


Filename is optional. When filename is not used the 
input card file opened will be tabeled "HASP/CARDSIN®. 
If filename is present the fite opened wilt be labeled 
<filename>. 

Filename can be of the following formats: 


le A 


20 ASB 
3-2 ABC 
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Where A» B and C are character strings of 10 or tess 
characters. re | a 


: | > be oSP1 <filename> 


eSP1 is for reading a HASP disk output spool and 
printing or punching the records. Filename is optional. 
When filename is not used the spool file opened will be 
Labeled “HASP/PRINTO1"%. If filename is present the 
spool file opened witt be labeled <filename>. 
<Filename> can be of the following foramats:. 


ae a 1. A 
3. A/B/C 


Where As Bs and C are characters strings of 10 or tess 
characters. | , ’ 


Ce BOTH 


BOTH is for reading a card file tabeled "“HASP/CAROSIN® 
| . and creating a spoot file labeled "HASP/CARDS™ while 
_ i reading a HASP output spool Labeled *HASP/PRINTO1® and 
© printing or punching the records. 


There is no optionat filename with BOTH. 

After the operator has correctly responded» HASP/SPOOL will test if 
run time parameters are already set from disk. If not» HASP/SPOOL 
will display the following message? | 

USE DEFAULT PARAMETERS? 


Run time parameter entry occurs at this time. See RUN TIME 
PARAMETERS for explanation of run time parameters. — - | 


SPOOL MODE GUTPUT OPERATION 


| When HASP/SPOOL is executing in the output environment CSP1Ds 
HASP/SPOOL opens a disk file tabeled “HASP/PRINTO1® or optional | 
"filename. The first record of the fite is a parameter record. 


oS eS 


a 


i 
i 
H 
dl 
A 
4 
y 
aH 
ut 
a 
oy 
i 
i 
i 
si 
3 
4 
4 
‘ 
i 
sa 
al 
A 
i 
ay 
ct 
y 
: 
fy 
i 
i 
| 
4 
A 
( 
is 
it 
i 
; 
i 
i 
4 
: 
i 
| 
h 
| 
i 
i 


a 
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HASP/SPOOL compares its run time parameters with the parameters. 


used to create “HASP/PRINTOL". Should the differences between the 


sposted fite and HASP/SPOOL parameters be serious (for. examples 
buffer size)» the program wilt print an error message and stop. Any 


 non"serious difference will cause a warning message to be printed 
and HASP/SPOOL will continue. 


After the parameter check HASP/SPOOL Starts decompressing and 
outputting the disk file. The disk file is read until end of fite 
1s detected and then closed. 


Should the special forms request message display: 


"508 XXX LOAD XXX FORMS IN RM<ID>.PRI® 


HASP/SPOOL will wait until the operator toads the speciat forms ‘and | 


answers with: 


<mix # of SPOOL>AXSSRM<ID>.PR1 or 
<mix # of SPOOL>AXS$SRM<ID>. PUI 


depending upon whether a punch oe Pe Oree request was seen. 


ALL other SPO messages peceives by HASP when the Spool file was 
pent created witt also be displayed. | es 


SPOOL .MODE INPUT OPERATION 


When HASP/SPOOL is executing in the input environment (.SR1)> 
HASP/SPOOL opens. an output disk file labeled "HASP/CARDS® and an. 
input card file named "HASP/CARDSIN® or optionally “filename*™. The 
card fite ts read until end of file is detected and then the card 
file is closed. Atl card records are compresseds blocked and 
written to the disk nen: Subsequent card files can now be added 
(sea FILES). | 
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END OF INPUT OR OUTPUT OPERATION 


When either the output node detects end of file on disk spool or the 
input mode detects end of file on the card file» the following 
messages are displayed on the SPO: 


END OF FILE» ENTER COMMANDO 
ACCEPT 7 


The four valid responses are: 


sen oe ee eS a eee SS eS ee 


Le <mix # of SPOOL>AX«SR1 <filename> 


AXeSR1 causes HASP/ SPOOL to again open a card file named 
"HASP/CARDSIN™ or optionally *fitename* and add it to the existing 
"“HASP/CARDS” disk file. 


2e <mix # of ‘SPOOL>AX. SP1. <filename> 


© AX.SP1L causes HASP/SPOOL ‘to again open a disk file. naned 
*HASP/PRINTO1® or optionatly “filename”. A parameter comparison 
test is made and the disk fite is output. | | | 


3. <mix # of SPOOL>AX. RSI 


AXeRS1 is an operator command to resume iain. or punching. a 
spoot. If during the execution of HASP in the spool mode the output | 
spool file "HASP/PRINTO1" is filled with compressed datas that file 
is  ctosed and a new file tabelled “HASP/PRINTO2" is opened = to 
receive the continuation of compressed data. At the end of the HASP. 
session there will be two spool files» “HASP/PRINTO1* and 
"HASP/PRINTO2"%. <mix # of SPOOL>AX.RS1 can be used to output the 
continuation spool. | 


: NOTES Continuation spools are maintained automatically untit. 
_ Ts end of current Session. 
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The following is an. example procedure to. follow in order —- 
the spool when the spoot is contained in more than one file. 


I. HASP fills the first disk area atlocated to “HASP/PRINTO1L" 
and the following Messages are displayed: 


ENO OF OUTPUT SPOOL AT Csequence #) 
HASP/PRINTOL FULL = RESUMED AS HASP/PRINTO2. 


IIT. HASP/SPOOL is now executed by the operator with the 
following disptays and Geren en | | | 


SPOOLED MODE 

ENTER ~SR1 FOR INPUT OR SPI FOR OUTPUTees 
ACCEPT 

LAXeSP1 

USE DEFAULT PARAMETERS? 

ACCEPT 

LAXYES 

END OF FILEs ENTER COMMAND 


IfIl. Now the operator can finish outputting the spool with the. 
resume command: | 


LAXRS1 
se <mix # of SPOOL>AX «CLOSE 


CLOSE causes HASP/SPOOL to close alt files currently open and 90 to 
end of job. | 


These responses are onty permitted uiven the END. oF FILE" message. 
amas been displayed. 3 


1) 


a ESE Ss Pees tea Se Pena. | Sates et ase) Se ee eT Ae Eh Se gee: tea Od eae See ERE ee See eee ee ae SEEN ee TS ee EES Petre Ors ETS Cee MT | SER eee cs CLE SRT eae MP eee ees eRe E EST! 
i, oe ae — = a a ge Oe a Se 5S ae Rag Ee ac ta ea CRED eg CRN ESED Pinch oe bd Stes s 25> EAT, REE ec ta tees bi not bE utes access eee te re Peet ade 2225 5h! Sek oh ees eid eats sere res Rh see ere 3 peate Z 
af a St EOS ST OP Oe OL ae FO Nee Se I OF AS SI See et eee Fe - S = FSi thas I ee ee a ae = BESS ts taal seni eoanca Ea Pench ents Sti 2522 ea See 
ee ee ee ge ee ee ee ee ge any ee ee cee eg a a Ee ae SE ee = as see = - 


Input; 


OQutput: 


Parameter: 
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FILES 


i SPOOL # NODE FILES 


"HASP.IN® tabeled "HASP/PRINTO1® 
Record size = buffer size 
Blocking 1 record per block 
Device is disk 


-"HASPCARDS" tabeted “HASP/CARDSIN™ 


Record size = 80 


Blocking 1 record per block 


Device is” card 


"HASPPRINT® labeled “HASP/PRINT™ 
Record size = print size 
Blocking 1 record per block 
Device is printer or backup disk 


“*HASPPUNCH® Labeted *"HASP/PUNCH® 


Record size = 80 
Blocking 1 pecena per block 
Device is punch or backup disk 


"HASP.OUT™ Labetled *HASP/CARDS™ 
Records size = Buffer size 
Blocking 1 record per block 


Device is disk 


"PARMS" Labeled "HASP/PARMS” | 


Record stze = 80 


Blocking 1 record per block 
Devices a) If program switch 
zero is not set» 
device is disk. 
. 6) If program switch. 
- zero is sets device 
is card. : 
c) If device is disk 
and file is not | 
presents device is 
changed to card. 
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DYNAMIC MEMORY SIZE 


‘7 OD GD G2 OD GD 4D UD GD OD DO) @ HO ee Ee 


The HASP/RJE buffer sizes are determined by the run time parameter >» 
BUFFER = <nm>» where n is the size of the teleprocessing buffer 
dectared in the host system. In order to accommodate att 
instatlations>, memory buffers are kept in a dynamic memory area. 


The dynamic size is computed by: 


(Cbuffer size) * 23 « 8 = # of bits required 


For any buffer size different from the default size of 400 bytes 
€3200 bits)» the HASP/SPOOL program must be modified via the MCP or 
executed with a memory statements i-.ees 


 2EX HASP/SPOOL 
2ME=6400 


where the ME statement specifies the number of bits as computed 
above. ar | 


SPO MESSAGES 


HASP/SPOOL has four types of SPO messages? 


ae OPERATIONAL 

be PARAMETER ANALYSIS 
Ce INPUT SPOOL ANALYSIS 
de ERROR 


OPERATIONAL MESSAGES 


Ee ee ee eee ee ee oe oe ee ee ee ee ee ee 


Message 7 Reason 
SPOOLED MODE | Run Mode 


ENTER .SR1 FOR INPUT «SRL Request — 
FOR OUTPUT OR BOTH FOR | 
INPUT AND OUTPUT TOGETHER 


END OF FILE+ ENTER. ‘Input card fite 
COMMAND | or input spool 
EQF detected 


PARAMETER ANALYSIS MESSAGES 
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OPERATIONAL MESSAGES that reGuice a response fron the operator to 
direct the further operation of HASP/SPOOL. 


Respo ns e@ 


 Swmeanae @ 


None 


See SPOOL MODE OPERATING 
INSTRUCTIONS | 


See END OF INPUT OR 
OUTPUT OPERATION 


Parameter analysis messages are messages displayed. whenever an error 
is detected in anetyeng run time Patoreces entry. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
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Message 


INVALIO ID PARAMETER 


NO PARAMETER ENTERED 


INVALID ADDRESS 
PARAMETER. 


INVALID BUFFER 


PARAMETER 


INVALID PRINTER 


PARAMETER 


COMPRESSION TYPE 
INVALID 


INVALID COMPRESSION 
MIN 


INVALID QUEUE 
PARAMETER 


XXXXXX INVALID | 
PARAMETER» PLEASE | 
CORRECT AND RE“ENTER 


USE DEFAULT PARAMETERS? 


_ INVALID RESPONSE» TRY. 


AGAIN 


PARAMETER FILE ON DISK | 


NOT VALID 
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Reason 


Run time parameter for I0= is not a one 
or two digit entry» or is not fotlowed by 
a blank. 


No entries in record in file 


“HASP/PARMS%. 


Run time parameter for ADDRESS= is not | 
in the form ADODRESS=P2C2A2 or the ports 
channel or adapter number is invatid. 


Run time parameter for BUFFER= is not 
in the range of 132 to 4095» or is not 
followed by a blank. 


Run time parameter for PRINTER= is not 
120 or 13264 


Run time parameter for COMP. TIME= is 
not QO» ils 2s or 3. 


Run time parameter for COMPRESSION. MIN= 
is not in the range 2 - ‘31. 


Run time Saraneter for QUEUE= is not 
in the range 2 = 4. ae 


Message is displayed upon detection of 


first error in a parameter list 
XXXXXX is invalid entry. Alt parameters 
must be re~entered. 


Request for run time parameter entry (see 
RUN TIME PARAMETERS). | 


Neither "Rs “YES"» (Par ameter List] nor 
/*®SIGNON was entered in response to “USE 
DEFAULT PARAMETERS”. 


*HASP/PARMS™ disk fite contained invalid 


parameter and will not be used for run 
time parameters. 


Sn eee ee ee ee ee SE 
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INPUT SPOOL ANALYSIS MESSAGES 


When HASP/SPOOL is executing in the spool output modes the 
“HASP/PRINTOI" disk spool is opened and the first record which 


contains the. parameters with which the spool was created is read. 
These parameter are compared against the current = run time 
Parameters and iff an error occurs one or more of the _ following 


messages are disptayed: 


Message _ Reason 
ERROR: “BUFFER®= | Current size of HASP/SPOOL buffer does 
PARAMETER DOES NOT not match spoot buffer size. Correct 
| _ AGREE WITH SPOOL.= and re-execute 
| programe. | : 
ERROR3 “*COMP.TYPE® | Current COMP.TYPE of HASP/SPOOL does 
PARAMETER INVALID | not match COMP.TYPE of spoot. | 


ERROR? "COMPRESSION. MIN" Current COMPRESSION.MIN of HASP/SPOOL 
PARAMETER INVALID | does not match COMPRESSION.MIN. of spool. 


ERROR MESSAGES © 


Error messages are displayed whenever an operationat error is 
detected by ants SEQUts | 


Message 7 | Reason > 
ERROR? CONTROL BYTE ~~ The first byte of a record to or ‘réi 


INVALID» BLOCK SKIPPED. #HASP/SPOOL is a control byte. Shoutd it 


be invalids this message will be 
disptayed and the b lock ignored. | 


| ERROR? ONLY ONE INPUT Since multipte devices are not currently 
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OR OUTPUT STREAM 


CURRENTLY ALLOWED 


SEQUENCE ERROR 
ENCOUNTERED Ccount) 


ERRORS ONLY ONE OUTPUT. 


OR OUTPUT STREAM 
CURRENTLY ALLOWED 


ERROR? INVALID “SRCB*>» 
RECORD SKIPPED 


ERROR? INVALID SCB 
LENGTH ENCOUNTERED 


INVALID MESSAGE LENGTH 


ENCOUNTERED 


INVALID "RCB" DETECTED» 
BLOCK SKIPPED 


ERROR? SPOOL FILE EMPTY 


INVALID RESPONSE 
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possibles should a block be received for 
an additional devices this message is 


displayed and the block ignored. 


Att message blocks in the spool are | 

internally sequenced. Should a block be 
losts this message is displayed along 
with the sequence count of expected. The 


block is unpacked and output. 


Message block contained a RCB for. 

other than stream number 1. 

Blocking is skipped an the first seeeton 
is output on the SPO. 


Message block contained an invalid 
SRCB. | 


Length of SCB was greater than output — 
record size. Only the portion of the. 
record equat to output record size is 
processed. 


Ail message blocks eee: a Agasen field 
giving the tength in bytes of the test in 
the block. Should this length be greater 
than permitteds this message is disotayed 
and the permitted portion of the block is 
processed. 


HASP/SPOOL detected an invalid Soe 
the block is ignored. 


The input spoot contains no records. 


This message witt be displayed. for any 


invatid response to an ACCEPT condition. 


The program will then wait for another 
input message. 


ALPHABETIC INDEX? 


DIRECT MODE 

DYNAMIC MEMORY SIZE 

END OF INPUT OR OUTPUT OPERATION 
ERROR MESSAGES , 

FILES 

BHENERAL 


INPUT SPOOL ANALYSIS MESSAGES 


QPERATIONAL MESSAGES | 
PARAMETER ANALYSIS MESSAGES 
PARAMETER DEFAULTS AND. FORMATS 
PARAMETER LIST ENTRY | 

RUN TIME PARAMETER DEFAULTS 

RUN TIME PARAMETERS © 

SPS MESSAGES 

SPOQL MODE 

SPOGL MODE INPUT CPERATION | . 
SPOOL MODE OPERATING INSTRUCTIONS 
SPOOL MOOE OUTPUT OPERATION 

SPONAL Phase #1 

S?O09L Phase #2 

SPQ0L Phasa #3 

SYSTEM REQUIREMENTS 
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GENERAL 


quality of a Binary Synchronous (BSC) tine between aio SBurroughs 
B1700 computer with a Single Line Controt (SLC) or Multi-Line 
Control (MLC)» using the Burroughs BSC EBCDIC line adapters and an 
I3M computer with a compatible Binary Synchronous Control. 


| TESTBSC. is a 81700 SDL program written to exercise and verify the 


TESTBSC requires a Burroughs-written 360/370 OS BAL program named 
BURRBSC to be executing in the IBM computer. See technical 
documentation of BURRBSCs» HASPCsection IV)» for a description of 
the host program. | 
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OPERATION | 


TESTBSC can run in one of four nodes? 


C1) Leased transparent 

(2) Leased non-transparent 
(3) Switched transparent 

(4) Switched non-transparent 


TESTBSC makes the connection with the IBM computer Cdependent. on 
leased or switched) and transfers 256 messages to the I8M computer 
which witl echo the message back. The format of each message is 
different and alt possible bit configurations are transmitted. The 
echoed message is compared to the transmitted message and any 
noncompares are togged. | 


After 256 messages have been successfully echoed or error retries 


are exhausted» TESTBSC prints the results of the test and goes to 
end of job. | | , 
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‘OPERATING INSTRUCTIONS. 
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RUN TIME PARAMETERS 


After execution of TESTBSC» the following messages wilt be output to 


the SPO. 


USE DEFAULT PARAMETERS? 


TESTBSC is asking whether to use the defautt parameters 


SWITCHED 
TRANSPARENT 
ADDRESS 73212302 


or to use the parameters entered through the SPO or via a card file. 


| To use the default parameters, reply: <MIX # sale TESTBSC>AXYES.. 


To override a defaults enter. <MIX r OF TESTBSC>AXCP ar ameter List] or 
<MIX # OF TESTBSC>AXR where (Parameter List] is a free form tist of 


parameters» and R signifies that the parameters are in a card file 


Labelled “HASP/PARMS". Valid parameters are: 
LEASED for leased tine 
NONTRANS for non-transparent 


ADDRESS=P3C2A: for address of adapter where 


P = 1 digit port number 
C = 1 or 2 digit channet number 
A = 1 or 2 digit adapter number 


EXAMPLE: 


<MIX # OF TESTBSC>AX LEASED | 
 SMIX # OF TESTBSC>AX NONTRANS LEASED | 

<MIX # OF TESTBSC>AX ADDRESS=721220: LEASED NONTRANS 

<MIX # OF TESTBSC>AXR 
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If an invatid parameter is entered» an error message wilt be 
displayed containing the first 8 bytes of the parameter in error. 
The operator can correct the error and re~enter YES» (Parameter 
List] or R.e 


To be compatible with the HASP/RTP programs the same HASP/PARMS card 
file can be used. Unused parameters including the /*SIGNON card are 
ignored. | | 


After successful parameter inputs» the line is broken if it is a 
Switched tines then the presence of the adapter and the control is. 
checked and the strapping option of the adapter is verified to be 
the same as specified (either LEASED or SWITCHED). Appropriate 
error messages are displayed. | | 


If the proper hardware is ready and the connection is a LEASED tine» 
then one of the following messages will be displayed: 


C1.) BURRBSC TEST 2 MUST BE RUNNING IN IBM COMPUTER 
| for transparent data or | 


C2.) BURRBSC TEST & MUST BE RUNNING IN IBM COMPUTER 
for ene a nerer ent data. — | | | 
If the ‘gonnection is a svuecnec Lines one of the following messages 


will be cispeeyens 


(1.) DIAL IBM COMPUTER WITH BURRBSC TEST 2 RUNNING. 
for transparent data or | a | 


(2.) DIAL IBM COMPUTER WITH BURRBSC TEST 4 RUNNING 

for non-transparent data. 7 ss 
After connection has been made the fottowing message witi be 
pveR eee _ 42* eo. | mh, 


CONNECTION MADE 
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INQUIRY 


After the connection has been established» TESTBSC witl send an SOH 
ENQ@ sequence to BURRBSC» which will respond with an ACKO.. 


If there is no reply to the SOH ENQ sequence and the Pannectien is 
leased» an error message is printed. On both leased and switched 
lines», the retry counter is decremented and tested. If the retry > 
counter is not zeros the SOH ENQ is retransmitted. If the retry 
counter goes to zero before receiving a valid ACKOs TESTBSC witt 
print summary results and go to end of job. . 


TEST TRANSFER 


Text transfer starts after connection has been made and an ACKO 
received to the SOH ENQ sequence. The test buffer will be of two 
formats. | 7 


Transparent ° all 256 possible bit patterns. | 
Non-transparent - 256 characters with Hex 00-3F having | the 


most significant bit on to avoid being a tine 
control character. 


Before transmissions the text buffer is rotated. 


Upon completion of the transmission and the following read for the 
echoed response» the [1/0 operation is tested for errors. If an 


error is detected» the error is logged on the printers the error 
retry counter is decremented and tested. If the retry counter is 
zeros the summary results are printed and TESTBSC goes to end of 


job. If the retry counter is not zeros the tast message’ is 
retransmitted. | | | | | 


If no line error was detected» the read buffer is tested for a NAK 
and if a NAK was receiveds the NAK is logged on the penne and the 
last message is retransmitted. | 
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If comptetion is good and a NAK was not receiveds the received data 
is compared to the transmitted data. If a compare error is 
detecteds §§$an error message is printed» the retry counter 
decrementeds and the last message retransmitted. 


If the received and transmitted data compare then the text buffer is 
rotated one position so that each of the 256 messages transmitted 
will be different and the end of messages condition is tested. If 
not end of messages» the next text buffer is transmitted. If end of 
messages» a OLE EOT is sent to tett BURRBSC that the test is 
complete. TESTBSC then prints the test resuits and goes to end of 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


ERROR MESSAGES 


Message 


READ TEXT ERROR 


SEND ENQ ERROR 


RESULT DESCRIPTOR ONE Neo<N 


RESULT DESCRIPTOR TWO NeeeN 


READ EXCEPTIONS 
WRITE EXCEPTIONS 


CRC ERROR 

READ MEMORY ACCESS ERROR 
WRITE MEMORY PARITY ERROR 
TIME OUT ERROR 

BREAK RECEIVED OR DETECTED 
NO ENDING CONTROL DETECTED 
LOSS OF DATA SET READY 
LOSS OF CLEAR TO SEND ON 
WRITE OR LOSS OF CARRIER 
ON READ 

WRITE BUFFER 

READ BUFFER 

READ OF ODIO NOT COMPLETE 


NO DATA RECEIVED | 
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Meaning 


1/0 =exception during message transfer 
1/0 exception during Inquiry 

First result descriptor - Write Op 
Second result déscriotee - Read Op 


fsiled = 


Read Op reason  fottlows 
message 
Write Op failed - reason follows 


message 


Exception 


Exception 
Exception 
Exception © 
Exception 
Exception 
Exception 


Exception 


Write buffer follows in Hex 
Read buffer fottows in Hex 
No read buffer because Write Op faited 


No data read into receive buffer 


3-8 


BURROUGHS CORPORATION _ COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | "3 B1700 HASPC(Section IIT) 


SANTA BARBARA PLANT PP. Se 2212 5256 


RESULT MESSAGE | 


am 22 G2 OD GS OF OD = OD a oF on aD 


At end of job the following message will be printed. 


— = A a on 


ma i. A ab am 


B1700 BSC LINE VERIFICATION RESULTS 


| i 
SWITCHED i 
> LINE 
LEASED 4 
| , 1 


TRANSPARENT 
: TEXT 
NON= TRANSPARENT 


aman VW =m = 


ADDRESS = P:C3A2 | | | 
NUMBER OF SUCCESSFUL MESSAGES ECHOED nnan 
NAKS RECEIVED nnnn 

CRC ERRORS annn 

TIME OUTS nnnn 

OTHER LINE ERRORS aan 


DATA COMPARE ERRORS nnnn 
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SPO MESSAGES 


Message 


DIAL IBM COMPUTER WITH 
BURRBSC TEST 2 RUNNING 


DIAL IBM COMPUTER WITH 
BURRBSC TEST 4 RUNNING | 


BURRBSC TEST 2 MUST BE 
RUNNING IN IBM COMPUTER 


BURRBSC TEST & MUST BE 
RUNNING IN IBM COMPUTER. 


SWITCHED ADAPTER BUT TEST 
CALLS FOR LEASED 


LEASED ADAPTER BUT TEST 
CALLS FOR SWITCHED © 


NON BSC ADAPTER NNNNNNN 


EBCDOIC BSC Line adapter. 
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Meaning 


a a an an ne ae 


TESTBSC was executed with the switched . 


line and transparent options. The 
compatible host test is BURRBSC Test 2. 
Operator must now manually dial host. 


TESTBSC was executed with the switched 


line and non-transparent options. The 
compatibie host test is BURRBSC Test 4%. 


Operator must now manually dial host. 


TESTBSC was executed with the leased 
Line and transparent options. The 
compatible host test is BURRBSC Test 2 
which must be running or after 11 
consecutive line errors TESTBSC will 
abort e 


TESTBSC was executed with the Leased 
fine and non-transparent options. The 


compatible host test is BURRBSC Test 4& 
which must be running or after 11 
consecutive line errors TESTBSC wittl 
abort. 


TESTBSC was executed with the leased 

Line option but the adapter was found 
to be a “switched* adapter. TESTBSC 

wilt abort. 


 VESTBSC was executed with the switched © 


line option but the adapter was found 
to be a “leased” adapter. TESTBSC will 
aborts | 


The adapter was found not to be the 
NNNNNNN is 
the ID of adapter found. TESTBSC will 


abort. 
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ERROR RETRIES EXHAUSTED 
ON # BREAK 1 

1 SEND ENQ ¢ 

{ READ TEST 4 


USE DEFAULT PARAMETERS 


OOOO INVALID PARAMETER 
CORRECT AND RE~ENTER 


NO PARAMETERS 
ENTERED 
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Error retry counter reached zero. 


Seven consecutive errors were detected 


on all operations except send SOH ENQ 


where the count is 11. Summary resutts 
wilt now be printed and TESTBSC will 
abort. 


TESTBSC is asking operator whether or 


not to use the default parameters. 


Correct responses are: 
"YES", use defaults 


"RW >» parameters are in card file 
tabelted HASP/PARMS 


CParameter List] tlist of parameters. 


TESTBSC parameter analysis found an 


invalid parameter. XXXXXXXX is the 


first eight characters of the parameter 
detected as invalid. This message is 


printed as the first invalid parameter 


in a card image or SPO entry is 
detected. Subsequent parameters on 
that card tmage or SPO entry are not 
checked. The operator at this time 
has the same options as to the 


response of "USE DEFAULT PARAMETERS". 


For a card file each card image is 


analyzed before operator is given a 


chance to correct the invalid parameters. 


It ts important to note that alt 


parameters must be re~entered and 


not just the corrected invalid 
parameter. 


TESTBSC parameter found no. parameters 


in the card image or SPO entry. 


Operator now has the same options as 
to the response to “USE DEFAULT | 


PARAMETERS". 


BURROUGHS CORPORATION 
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ENTER OTHER PARAMETERS 
OR YES FOR DEFAULTS 


3711. 
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The first SPO entry was a "SIGNON*. 
Operator now has the same options as 
to the response to "USE POuAUEY 


PARAMETERS". 
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- GENERAL 


ae 


be 


 BURRBSC fs a diagnostic program designed to perform two. functions: 


To aid Burroughs field engineers using the 81700 diagnostic 
BSC/5-3 in the installation and maintenance of an EBCDIC binary 
synchronous connection between a 81700 used as a eremote 
terminal and an IBM 360/370 HASP/RJE host. 


To be a responder to the 81700 binary synchronous tine. 
verification programs TESTSSC. TESTBSC and BURRBSC can be used 
to verify the operation of the binary synchronous hardware 
Cadapterss controls» modems» tines) before a HASP/RJE session. 


BURRBSC is designed to run in the host 360/370 under the I84 


Operating System (0S) environment to minimize system interference 


at the IBM System 360/370 site. | 
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DESCRIPTION OF TESTS 


Th GO A GD ED 8 EE GF 4D OF 8 BE EEE EE ODO @® 


BURRBSC will act as a responder to messages received from either 
Burroughs Field Engineering dtagnostic 85C/5.3 or Burroughs tine 
verification programs TESTBSC. Refer to the documentation of 
BSC/5.3 or TESTBSC» HASPCsection [11) for a description of 
operating instructions for these two programs. | 


BURRBSC consists of a series of tests that can be run individually 
or sequentially. The tests are designed to check ail aspects of 
binary synchronous transmission protocol as used with the HASP/RJE 
system. : 


The following is a list of alt cebpaspendine tests between - BURRBSC 
and the 81700 programs 8SC/5.3 and TESTBSC: 


BURRBSC | | BSC/5.3 | TESTBSC 
02. 7 i _ | Transparent Mode 
(04 > a Non Transparent Mode 
06 | Oo 5 NSA 
12 Cle¢26¢5) _ NAA 


INITIALIZATION OF TESTS 


Atl tests start with the following channel Progress to receive the 
bid CSOH ENQ) from the B1700: —— co 


OISABLE 
SET MODE 
ENABLE 


READ 
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If a timeout occurs at the READ commands the channel program is 
restarted at the READ command with no error message. Timeouts 
waiting for SOH ENQ are not considered tine errors by HASP/RJE.~ Alt 
other line errors are reported and the channel program is restarted 
at the DISABLE command. All non-timeout errors are retried until 
the error retry limit ts reached. When the Limit is reached the 
test is ended with an error message to the operator. 


TEST ECHO PHASE 


After the initialization phases alt tests wilt respond ACKO to the 
SOH ENQ and begin echoing received text. The type of echoing by 
test is as follows: 


Test 02  €Eehoes Transparent Text 
Test 04. - Echoes Non Transparent Text | 
ese = Test 06 Echoes with a 2 second delay and then ACKO 
Test 12 Is a sequential execution of test» 02 04 and — 


066 


Each test wilt run untit a DLE E0T sequence is received from 85C/5.3 
or TESTBSC in the 81700- This allows the Burroughs B1700 program to 
determine the tength of time for each test to rune In addition the 
message length and content wilt be selected at the B1700 computer. 
For 85C/5e3» the tength will be selected at run time and may vary 
from 10 to 400 bytes. The data will be selected at run time and may 
be either "canned®* messages or user specified. For TESTBSC» a 259 
byte test buffer wilt always be received. The buffer will contain 
3 data tink controt characters and 256 nontransparent or 
transparent text bytes. | _ _ 7 | 
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TEST ENDING PHASE 


Atl tests will continue to echo received text untit a OLE EOT 
sequence is receivede At that time the test wilt end. If the 
selected test was test 12 (run alt tests sequentially)» and the 
last test was not Test 06% then BURRBSC will step to the next test. 
€04 or 06)» bypass the OISABLEs» SET MODE and ENABLE and issue the 
READ command to wait for the next bid (SOH ENQ). 


TEST ERROR RECOVERY 


Error recovery procedures are designed to be similar to those used 
by HASP/RJE system with a few changes to facilitate the diagnosing 
of tine errors. The main change is the addition of an extensive 
printout for each tine error detected. The error printout is 
described in 1/0 errors printout. | 


The basic error recovery philosophy is to tog any error and then 
write a NAK chained to a read text command. There are _ two 
exceptions to this: | 


ae If a timeout occurs during the initialization phase no error is 

logged and only the read command is re~issued. This is. to 

prevent excessive togouts while waiting for the SOH ENQ from 
the B1700. 


be If a NAK is receiveds the NAK is logged and the last message is 
retransmitted. This will prevent a NAK“NAK loop between the two 
programsSe | 


After each error is logged the retry limit is tested to see if the 
consecutive number of errors detected is equal to the Limit. If the 
limit is reached» the operator is notified by an error message on. 
the console typewriter and the test is ended. The retry timit is 
reinitialized after each successful reception. © 
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OPERATING INSTRUCTIONS 


BURRBSC will be released as a source dec k that must be assembled and 
Linked prior to execution. 


ASSEMBLING AND LINKING BURRBSC 


Prior to assembling BURRBSC» proper JCL ltseaetten must be obtained 
from the IBM site's system programmer to insure the JCL meets all 
the unique specifications for that instatlation. The following JCL 
is a Sample of the JCL needed to assemble and tink BURRBSC into 
~SYSL.LINKLIB COS normal execution library). The punching of JCL 
cards must start on column one (1) of the card. os. | | 


S/FASEM JOB MSGLEVEL= 1 
4/A EXEC ASMFCLs ASM. PARN= * NODECK® 
SF ASMeSYSIN DD* 


NAME BURRBSCCR) 
4 


EXECUTION OF BURRBSC 


7 The following is an example of JCL required to execute BURRBSC. 


4/BSC JOB MSGLEVEL=1 

S7A EXEC PGM=BURRBSC 
S7SYSPRINT DD SYSOUT=A_ CA) 
7/TCOO DD UNIT=XXX (B) 


CA) UNIT=XXX CXXX=Unit Address) may be substituted for SYSOUT=A> if 
a printer is available for direct allocation. 
(B) XXX in UNIT=XXX is the address of line to be tested. 
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TEXT EXECUTION 


After the program has started it will disptay on the system console 


BURRBSC BURROUGHS 81700 TO IBM BISYNC TEST 
*XX BURRBSC = ENTER TEST REQUEST 


To start a test reply in the following manner: 


r XXe*t/mamsp/y or nt 


t/mm is the only required parameters where am is the two digit test 
number. p/y or n is optional and specifies whether error printouts 
will be printed Cy) or not (n). The defautt is p/y (print errors). 
Hhen the selected test has completed» the test request message will 
be repeated to allow the operator to enter another test request or 
terminate the program. 


TEST TERMINATION 


To terminate BURRBSC reply "FXXs*end** to any test request message. 
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Message 


“BURRSC- “ENTER TEST 


REQUEST 


BURRBSC LINE 
OPEN ERROR 


INVALID PARAMETER= 
TRY AGAIN | 


INVALID TEST- 


TRY AGAIN. 


1/0 ERROR 


STATUS XXXX 
SENSE YY 


NO TEST PARAMETER- 


TRY AGAIN 


PRINTER OPEN 


ERROR 


TEST STARTED 


TEST ENDED 
XXXKX XK XXX 


MESSAGES 
TRANSFERRED | 


 BURRBSC CONSOLE MESSAGES 


Meaning. 


To enter next test 
request or “"end*. 


Error occurred on open 
macro for the line. 


Invalid parameter 
entered on test 
request. 


The test parameter was 
not a valid test 
numbere 


A permanent I/O error 
occurred on the tine. 


A test request was 
made without a T 
parameter. 


Error occurred on open 


macro for the printer. 


A valid test request 
was received and the 
test has been started. 


The requested test 
ended either normally 
or abnormally. 


XXXXXXXXXX is the totat 


number of messages. 
echoed by the program. 
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‘Action 


Enter eppropetste 
request. 


Line labeled TCOD 


Check parameters and 
re-enter request. 


Check test number and 
rem~enter. fest must be 
two digits. _ 


None» program witt 
terminate current test. 
and issue new test. request 
messagee | 


Check request and 
rementere 


Check specifications 
on OD card tabetled 
SYSPRINT. 


None 


None 
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BURRBSCh Test start up message.n None 
BURROUGHS 81700 | is the level number of 


TO IBM BISYNC BURRBSC. 


TEST 


Heed 


PECCEP PEEeey ys eck 


| | | 4-9 
BURROUGHS CORPORATION COMPANY CONFIDENTIAL — 
COMPUTER SYSTEMS GROUP | B1700 HASPC(Section IV) 


SANTA BARBARA PLANT Pe Se 2212 5256 


I/O ERROR PRINTOUT 


error detected. 


The fottowino is an explanation of the printout associated with each 


I70 ERROR FAILURE = XXXXXXXXX 


XXXXXXXXX fs an English representation of the sense information. 


SENSE = XX 


XX is the sense byte from the 10B. See appropriate IBN manual 
for specific bit meanings. | 


STATUS = XXXX 


XXXX are the Status bytes from the CSW. See appropriate IBM. 
manuals for specific bit meanings. a | , 


ECB = XXXXXXXXX 


XXXXXXXXX is a standard OS event control blocks. See appropriate 
IBM manuals for ‘meaning. , 


CSW = XXXeee XXX 


XXXeeeXKXX fs the channel status word from the 108. See 
appropriate IBM manuals for meaning. | es : 


CHANNEL PGM ADDRESS = XXX XXXXXX 


XXXXXXXXX is the address of the first CCW executed in the tast 
I/O operation. See CHANNEL PGM = betow for actual CCWts. 2 


eae CCW ADDRESS = XXX XXXXXX 


XX KKK AKKK is. the address of the CCH that failed in the tack 1/0 
Operation. Use this field with the previous field to find the 
eewEng cow in the CHANNEL PGM = field below. 
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FLAGS - AABBCCDD 


AABBCCDD are the flag bytes used by the ‘progran. They are 
defined below with bits numbered from left to right (0-7)... 


FLAG 1 = AA BIT USE CIf Qn) “USECIE Off) 
| 0 Test started No test entered 
1 | Print negated Print is on 
ZeT Not used | 
FLAG 2 = BB Test number in Hexe 
FLAG 3 = CC 0 Enable Mode 
| 1 3 Response Mode 
2 Text Mode 
3 End Mode 
4 Error Mode 
= al ie | Not used 
: Be FLAG & = OD *008 if test 2+ 4 or 6 
| *oc7* af test 12. See flag 2 for 
actual test number. 
— GD isc - count = xxxxxxxx 
XXXXXXXX fs the number of messages echoed before the error 
occurred. , _ , 
7” | 
CHANNEL PGM = XXX00eXXX 


J 7 XXXeeeXXX i5 the actual channel program executed on this 170 
ne operation. See channel PGM ADR & FAILING CCW ADDRESS fields for 
fo more information. 


“WRITE BUFFER 


The first byte of the next line is the haginaine of the contents 
of the write buffer of the last write command. This fietd may 
be empty on a single read command faiture. | | a 


READ BUFFER 


The aivet byte of the next line is the beginains. of the contents 
of the read buffer of the last read command. If the 1/0 error 
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occurred on a urite command or no data was receiveds. then this 
field will be empty. 


L=S - SiS pa ee Sh ee Se a. I PR tn ei 8 a ts et OS EE Sa i Ce a Pe PLS 
alin EES Se aS Se Lo eR Ss SOP DT 1 OE ie Ald Ae Sia LD a Sl EE OE LS NOS Nie 2S ELEN RT Bs as 8S EL Ls 


ea ESE RS SR wr Ses Be 


| ALPHABETIC INDEX? 
ASSEMBLING AND LINKING BURRBSC _ 
BURRBSC CONSOLE MESSAGES 


DESCRIPTION OF TESTS 
EXECUTION OF BURRBSC 
GENERAL 

170 ERROR PRINTOUT 
INITIALIZATION OF TESTS 
OPERATING INSTRUCTIONS 
TEST ECHO PHASE 

TEST ENDING PHASE 

TEST ERROR RECOVERY 
TEST TERMINATION 

TEXT EXECUTION 
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